軟體王 Softking

OpenClaude-Portable 解決的痛點極其具體：開發者想在受管電腦、離線環境、多台機器間切換、或不想污染系統環境時，依然能使用完整功能的 AI 程式碼助手。傳統方案需安裝 Node.js、npm 包、設定環境變數、登入帳號、同步設定，步驟繁瑣且留下痕跡。OpenClaude-Portable 採取 「自包含資料夾」架構：將 Node.js 二進位、npm 依賴、OpenClaude 核心、代理腳本、儀表板伺服器、Ollama 二進位與模型快取、設定檔全部置於專案目錄，透過啟動腳本設定 XDG_CONFIG_HOME、XDG_DATA_HOME、CLAUDE_CONFIG_DIR 等環境變數強制導向 data/，實現真正的零足跡。

架構亮點：

1. 雙平台啟動器：START.bat（Windows）與 start.sh（Linux/macOS）邏輯對等，支援跨平台共用 data/ 目錄——同一 USB 在 Windows 寫代碼、插到 Linux 繼續對話、macOS 開儀表板，歷史與設定無縫銜接。

2. 智慧系統提示詞代理（tools/local-proxy.js）：OpenClaude 原生系統提示詞約 10,000 tokens，對本地 CPU 推理（Ollama）造成嚴重首字延遲（60–120 秒）。代理攔截請求，將提示詞精簡至 ~300 tokens，首字延遲降至 5–20 秒，日誌靜默寫入 data/proxy.log 不干擾終端機。這是本地模型實用化的關鍵優化。

3. 自動更新快取機制：每日檢查一次引擎更新（GitHub Releases / npm），再次啟動時跳過網路請求，離線環境不卡頓。

4. 模型供應商抽象層：啟動選單與 Change_Provider.bat/sh 統一管理 9 種供應商，將 API Key、Base URL、Model Name 寫入 data/ai_settings.env，切換即時生效。自訂 OpenAI 相容 API 支援任意 /v1 端點、可選 API Key、自動抓取 /models 列表。

5. 網頁儀表板（dashboard/server.mjs + index.html）：Node.js 原生 HTTP 伺服器，提供 ChatGPT 風格對話介面、Agent Mode、工具卡片、思維鏈視覺化，Open_Dashboard.bat/sh 一鍵啟動於 http://localhost:3000。

6. 離線模型管理：Setup_Local_Models.bat/sh 封裝 Ollama 下載器，支援 gemma3:1b（~800 MB，最快）、qwen2.5:1.5b（~1 GB）、phi3:mini（~2.3 GB）等 CPU 推理友善模型，模型檔存於 data/ollama/，可複製至 SSD 提升 USB 2.0 瓶頸場景效能。

7. 會話恢復機制：RESUME.bat <session-id> 直接載入 data/openclaude/ 中的歷史會話繼續工作，無需重新進入選單。

8. 實戰級疑難排解內建：啟動器自動處理 Node.js 下載失敗重試、OpenClaude 引擎安裝修復、GitPortable 內建修復 Git Bash 缺失、連接埠 11435/3000 衝突自動清理、舊版巢狀 if 邏輯錯誤自動升級 等真實世界問題，展現作者對「USB 隨身碟實戰部署」的深度理解。

專案結構：

OpenClaude-Portable/
├── START.bat / start.sh / RESUME.bat          入口與恢復
├── data/                                      全部持久化資料（跨平台共用）
│   ├── ai_settings.env                        供應商/模型/金鑰
│   ├── openclaude/                            會話歷史與代理記憶
│   ├── ollama/                                Ollama 二進位與模型
│   └── proxy.log                              代理靜默日誌
├── engine/                                    Node.js + OpenClaude 引擎
│   ├── node-win-x64/                          內建 Node.js (Windows)
│   └── node_modules/@gitlawb/openclaude/      核心套件
├── tools/                                     輔助腳本
│   ├── local-proxy.js                         系統提示詞精簡代理
│   ├── setup_local_models.ps1/.sh             Ollama 模型下載
│   ├── Change_Provider.bat/.sh                供應商切換
│   ├── Open_Dashboard.bat/.sh                 儀表板啟動
│   └── Setup_Local_Models.bat                 本地模型設定包裝
└── dashboard/                                 網頁儀表板
    ├── server.mjs                             Node.js 伺服器
    └── index.html                             前端介面

功能特性

• 完全免安裝、零足跡：所有資料、金鑰、日誌、模型僅存在專案 data/ 目錄，不寫入宿主系統任何位置。
• 跨平台共用資料夾：Windows/Linux/macOS 共用同一 data/，USB 插拔即遷移，會話與設定無縫銜接。
• 9 大 AI 供應商整合：NVIDIA NIM、DeepSeek、OpenRouter、Google Gemini、Anthropic Claude、OpenAI、Ollama（離線）、LM Studio（本地）、自訂 OpenAI 相容 API。
• 雙運作模式：Normal Mode（寫入/執行前需確認）與 Limitless Mode（全自主無提示）一鍵切換。
• 網頁儀表板：ChatGPT 風格 UI，支援 Agent Mode、工具卡片、思維鏈視覺化，localhost:3000 存取。
• 本地模型極致優化：系統提示詞代理將 10k tokens 精簡至 300 tokens，CPU 推理首字延遲從 60–120 秒降至 5–20 秒。
• 離線優先設計：首次設定需網路，之後僅 API 呼叫需聯網；Ollama 模式完全離線可用。
• 會話恢復：RESUME.bat <session-id> 秒級恢復中斷會話。
• 自動更新快取：每日檢查引擎更新，離線環境不阻塞啟動。
• 內建 Node.js、Ollama、GitPortable：無需宿主預裝任何工具，USB 即插即用。
• MIT 開源授權：免費、可商用、可 Fork、可二次分發。

使用場景

• 受管企業電腦/學校機房：無管理員權限、禁止安裝軟體、USB 唯一可寫入儲存，插上即用 AI 程式碼助手。
• 離線/弱網環境開發：搭配 Ollama 本地模型（gemma3:1b/qwen2.5:1.5b），完全斷網編碼、重構、測試生成。
• 多機器開發者：桌上型電腦、筆電、雲端 VM、遠端伺服器間以 USB 攜帶完整開發環境與歷史脈絡。
• 隱私敏感專案：程式碼、API 金鑰、對話歷史絕不離開隨身碟，零遙測、零雲端同步。
• 教學/工作坊/面試：學生/候選人自備 USB 即擁有統一環境，無環境配置浪費時間。
• AI 模型快速評測：一鍵切換 9 大供應商、本地模型、自訂端點，對比同一提示詞在不同模型表現。

系統基本需求

• Windows：Windows 10 或更新版本（內建 Node.js，無額外相依）。
• Linux：需預裝 curl（主流發行版內建），glibc 相容 Node.js 二進位。
• macOS：需預裝 curl（內建），Apple Silicon/Intel 通用（Node.js 二進位為 x64，透過 Rosetta 2 執行）。
• 磁碟空間：~150 MB（Node.js + 引擎核心）；本地模型額外需 800 MB–8 GB（視模型大小）。
• USB 建議：USB 3.0+ 隨身碟/外接 SSD 以獲得最佳首次安裝與模型載入速度；USB 2.0 可用但首次安裝需 10–15 分鐘。
• 網路：首次啟動需聯網下載 Node.js 與 OpenClaude 引擎；後續僅 API 呼叫需網路（Ollama 模式完全免聯網）。

免費或付費與試用資訊

OpenClaude-Portable 本體為 100% 免費開源軟體，採 MIT License 授權，無任何付費版本、訂閱制、功能鎖定、廣告或遙測。
AI 模型呼叫成本由所選供應商決定：

• NVIDIA NIM：免費額度 1,000 credits/月
• Google Gemini：免費額度可用
• OpenRouter：含免費模型
• Ollama / LM Studio：完全免費、本地運行
• DeepSeek / Anthropic Claude / OpenAI / 自訂 API：依供應商計費標準 使用者自行申請 API Key 填入設定，工具本身不收取任何費用。

英文語言介面

目前介面與文件僅支援英文。啟動選單、設定嚮導、儀表板 UI、錯誤訊息、README 皆為英文，專案未包含多語言資源檔，Issue/PR 討論亦以英文為主。考慮專案性質（開發者工具、英文社群主導），短期內新增中文可能性較低。

總結

OpenClaude-Portable 是「為開發者實戰場景而生」的可攜式 AI 編碼助手典範之作。它不只是把 OpenClaude 打包成 ZIP，而是深度解決了「USB 隨身碟部署的全部痛點」：自包含 Node.js/Ollama/Git、零足跡環境變數導向、跨平台共用資料目錄、本地模型提示詞精簡代理（關鍵效能突破）、自動修復安裝失敗、會話恢復、儀表板、多供應商熱切換、Limitless Mode。作者對「首次安裝在慢速 USB 要等 15 分鐘」、「Git Bash 缺失導致 CLI 掛掉」、「連接埠殘留衝突」等細節的完整處理，展現極高的工程成熟度。

優點：真正免安裝、跨平台無縫遷移、本地模型實用化、隱私優先、MIT 開源、社群活躍、持續修復實戰 Bug。
限制：介面唯英、ARM64 原生支援未明（Windows x64 Node.js 經 WoW64/ARM64EC 相容）、大模型在 USB 2.0/CPU 上仍慢、非開發者上手門檻稍高（需理解 API Key/模型選擇）、無自動同步機制（靠手動複製 data/）。

若你是 需要在多台受限/離線/不同 OS 電腦間攜帶 AI 程式碼助手的開發者，OpenClaude-Portable 目前是 GitHub 上最完整、最實戰、最貼心的免費開源方案。強烈建議下載最新 main 分支、準備一支 USB 3.0+ 隨身碟、照著 START.bat 走一次完整流程，體驗「插上、啟動、編碼」的極致自由。